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RELEASE BULLETIN 
819-095000-251 


Rev 01 


GBASE IT Model_No:  APC-S$35 
(CP/M-86 VERSION) 


1.0 INTRODUCTION: 


dBASE II software is a database management tool that 
allows easy manipulation of small and medium sized data 
bases using English-like commands. With GBASE II you can: 


o create complete data base systems; 

eaSily add, delete, edit, display, and print data from 

your data base; 

maintain data files with a minimum of data duplication 

generate reports from one or more data bases, auto- 

matically producing subtotals, total, headings, and 

subheadings 

© create command stacks ("programs") to aid in data entry 
and retrieval 
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2.0 CONTENTS OF THE RELEASE: 
2.1 Distribution Media 
PART NO. DESCRIPTION 
819-076035-0500 Rev 01 dBASE II Diskette 


2.2 Documentation 


PART NO. DESCRIPTION 
819-095000-251 Rev 01 GBASE II Release Bulletin 
819-000100-8001 dBASE II User's Guide 

3.0 HARDWARE FITWARE EMENTS: 


3.1 Minimum Hardware Requirements 


APC-HO1 - Monochrome APC with single FDD 
See section 6.0 


3.2 Minimum Software Requirements 
APC-S01 - CP/M-86 Operating System 


Advanced Personal Computer NEC 
NEC Information Systems, Inc. 


4.0 


INSTALLATION PROCEDURE: 
PLEASE NOTE: 


Les 


The distribution diskette is already installed for 
the APC. Therefore the files INSTALL.CMD and 
STARTUP.PRG are not on your distribution diskette. 


Insert this replacement in the dBASE II User's Guide, 
Page 3-3, step 3 (STARTING UP): 


The system responds by displaying the message: 
Copyright (C) 1982 RSP Inc. 
*** BASE II/86 Ver 2.4 1 July 1983 


Floppy Diskette-Based: 


Refer to the procedures outlined in Chapter 2 of the dBASE 
II User's Guide. 


Hara Disk-Based: 


Complete the following steps if the execution programs are 
to reside on the hard disk. 


Ls 


Follow steps one and two (Formatting Diskettes and 
Making A Working Copy) as outlined in Chapter 2 of 
the dBASE II User's Guide. 


Use the PIP utility to copy the complete contents of 
the dBASE II working copy diskette to the selected 
hard disk drive (disk drive E:). Then, all the GBASE 
II execution files will reside on the hard disk. 


Follow steps three and four (Putting CP/M-86 And 
SUBMIT and the LOADER on the dBASE II Diskette) as 
outlined in Chapter 2 of the dBASE II User's Guide. 


Alter the file AUTSTRT.SUB on your GBASE II working 
copy diskette using the ED.CMD file. You need to 
change the default drive, so that the hard disk is 
used automatically. Insert a new first line to the 
AUTSTRT.SUB file. The first line should read "E:" 
(the default hard disk rive). Refer to the CP/M-86 
User's Guide for further information regarding the ED 
utility. 


To load dBASE II, follow the instructions in Chapter 
3 of the dBASE II User's Guide. Even though all your 
files are on the hard disk, you still need to boot 
from drive A. 


5.0 


ENHANCEMENTS: 
Wi ac ome Existin st 
l. MEM (memory) files built under previous versions of 


lie 


GBASE II are not compatible with version 2.4. These 
variables will have to be entered (once) and reSAVEd. 


All overlays and the system message file are now in a 
Single file DBASEOVR.COM. 
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A TEXT-ENDTEXT command has been added to assist in 

generating form letters and other block data appli- 
cations. This new command can save multiple ?, ??, 
or @ SAY commands. 


EXAMPLE: 
? "Dear "+Name 
TEXT 
This is an example of the very handy. 
new TEXT command in dBASE. 
ENDTEXT 
te Yours truly," 


It is now possible to use relative screen addressing 
with @ SAY GET commands. 


EXAMPLE: 
@ 10,20 SAY Address 
@ $+2,20 SAY “Good Morning“ 
@ $,$+2 SAY Name 


RELEASE command can now release subsets of all memory 
variables. 


RELEASE ALL LIKE <skeleton> releases all memory 
variables that the skeleton masks. 


RELEASE ALL EXCEPT <skeleton> does the opposite. 


The <skeleton> uses question marks to mask any single 
character, and an asterisk masks all remaining 
characters in a memory variable (up to ten of 
course). 


SAVE command can save memory variable subsets. 
SAVE ALL LIKE <skeleton> to <memory file name> saves 


all variables whose names are selected by the LIKE 
<skeleton>. 
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EXAMPLES: 
RELEASE ALL LIKE M* (releases all beginning 
with M). 
SAVE ALL LIKE ? DATE TO DATES (Saves MDATE, 
DBATE, ZDATE, etc.). 


A HELP command has been implemented. By typing HELP 
<command> user can get basic information about syntax 
and usage. This command calls the new file 
DBASEMSG.TXT which may be edited using a text 
processor or with MODIFY COMMAND. 


RANK () function implemented. RANK (<string>) will 
return the ASCII value of the first character of 
<string>. 


INDEX (no operands) indexes current record. Useful 
after a record is added by APPEND BLANK. 


REPORT strips high-order bits in form files. 


CREATE now checks for and prevents duplicate field 
names. 


MODIFY STRUCTURE checks for syntactically correct 
field names. 


DISPLAY can print semicolons after SET RAW ON. 


? and ?? do not put a space between fields after SET 
RAW ON. 


REINDEX command rebuilds multiple indexes from 
scratch using the original key expressions. Index 
files must have been specified by a USE command or a 
SET INDEX TO command. 


File name masking improved to allow X*.* to resemble 


EXAMPLE: 
DISPLAY FILES LIKE INV*.* 


EDIT, APPEND, CREATE, and INSERT can use format files 
to format screen with the SET FORMAT TO <file> 
command. This saves storing input to variables and 
then REPLACing them to the database file. 


EXAMPLE: 
USE INVOICES 
SET FORMAT TO INVFORM 
APPEND 
(user can just fill in the blanks to add data) 


16. 


17. 


18; 


Los 


20. 


21. 


TYPE function returns a "U" (Undefined) if expression 
is not parsable, even if a variable's parenthetic 
comments are syntactically correct. 


RESET command accepts a drive name and provides 
protection against open files on the drive as well as 
empty drives. 


EXAMPLE: 
RESET B 


Errors inside command files will show a traceback of 
the command files' nesting, called level by level. 


EXAMPLE: 
A*ESYRTAX ERROR* ** 
DISPLAY MEMRY? 
CALLED FROM INPUT.PRG 
CALLED FROM ACCOUNTS.PRG 
CALLED FROM MAINMENU. PRG 
CORRECT AND RETRY (Y/N)? 


After a PACK, GBASE will update all INDEX files 
currently used with a database. This results in a 
much speedier PACK and index update process. 


SET DELETE ON (default is off) makes dBASE ignore all 
recoras marked for deletion. All commands, including 
FIND and LIST, treat deleted records as invisible, 
except when a command addresses a deleted record by 
record number. 


DISPLAY STATUS shows USE database file names, system 
date, indexes, and their key expressions, as well as 
the status of all SET parameters. 


EXAMPLE: 
DISPLAY STATUS 
DATABASE SELECTED - A: TEST1.DBF 
PRIMARY USE DATABASE 


INDEXES: KEY EXPRESSION: 
A: TESTNAME.NDX ! (TST: NAME) 
A: TESTNMBR.NDX TST:NMBR 


UNSELECTED DATABASE - A:TEST2.DBF 
SECONDARY USE DATABASE 


INDEXES: KEY EXPRESSION: 
A: T2NAME.NDX ! (LAST: NAME) 
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TODAY'S DATE - 10/25/83 

DEFAULT DISK DRIVE - A: 

ALTERNATE - OFF BELL - ON 
(etc. for all parameters) 


UPDATE command can update in random order if USE 
Gatabase in indexed. Also, the REPLACE phrase can 
replace X with Y so that databases and update data- 
bases need not have identically named field names. 


Syntax: UPDATE FROM <file> ON <key> [ADD <field 
list>] [REPLACE <field list> or <field> WITH <field 
list> [RANDOM] 


RESTORE command can load saved memory variables 
without releasing the current memory variables using 
the ADDITIVE phrase. 


EXAMPLE: 
RESTORE FROM <file.mem> ADDITIVE 


A new option to the READ command NOUPDATE disables 
GBASE II from doing a check for changes in index file 
keys after each READ. Use this command to save time 
if you know that you will not be altering any index 
key fields. 


Trying to open a command or database file that is 
already open will now give the error FILE IS 
CURRENTLY OPEN. This will avoid the file stack 
overflow error and datafile confusion. It is 
suggested to issue a SET FORMAT TO SCREEN to close 
any FMT files. Issue a DISPLAY STATUS to view the 
selected primary/secondary database files, then 
SELECT PRIMARY/SECONDARY file and USE to close the 
file(s). 


6.0 CAUTIONS: 
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If a single floppy drive system (APC-H01) is used and 
you do not have the CP/M-86 utility PIP1, please 
contact your dealer for assistance in implementing 
the application start-up procedures. PIP1 is the 
Single-file copy utility for single-drive APCs. 


It is recommended that no more than one application 
package reside on any given floppy, because different 
application packages may require different soft key 
setups. 
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SET LINKAGE ON - When the current record pointer 
reaches EOF on the shorter file, the following 
message is displayed. 


FDD on G: Not Ready 
Type R(Retry), Any Key (CANCEL) 


Bdos Err on G: Select 


There is no way to correct this at this time. You 
must reboot. 


Using the SKIP command with an indexed file to skip 
beyond the end of file, will not display the "RECORD 
OUT OF RANGE" error message. Instead the record 
number and pointer remain on the last record of the 
index. 


Using the SKIP command with a non-indexed file, to 
skip beyond the end of file, will display the "RECORD 
OUT OF RANGE" error message. At this point the 
record number is incorrect and can display erroneous 
information about the record in use. It is advisable 
to issue a GO <n>/TOP/BOTTOM command at this time. 


?? =- using this feature causes the answer to write 
over the question depending on the length. In this 
case use of a single ? is suggested. 


DISPLAY ALL - When the first 15 records are dis- 
played, depending on the number of characters in a 
record, the first few records are lost due to 
scrolling. 


The commana QUIT TO <com file list> does not call 
programs from the system level. 


Do not issue a MODIFY STRUCTURE immediately after 
issuing a MODIFY COMMAND <file>. This can cause 
irrecoverable damage to your diskette. 


The system default is SET INTENSITY ON. In full 
screen edit mode, the data entry values will be high- 
lighted. In color APCs, highlight is red. 


There are four new SET commands: 


SET DELETE ON/OFF ~~ (default = OFF) 
SET MARGIN TO <n> 
SET COLOR TO <nl, n2> (not applicable to the APC) 


SET F<n> to <'new value'> (not applicable to the APC) 


Function keys have not been set for this version. 
Ignore Appendix I. Use the KEY utility that is 
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distributed with your operating system diskette to 
set the function keys. 


<CTRL><X> in full screen edit mode, deletes a 
character. Use <CTRL><F> to move the cursor down to 
the next field. 


If the error message "FILE IS CURRENTLY OPEN" is 
detected within a command file, the program will 
abort at that point and exit to the dot prompt. No 
error message will appear. It is suggested to issue 
a SET FORMAT TO SCREEN, a DISPLAY STATUS to view the 
selected primary/secondary database files. Then 
SELECT PRIMARY/SECONDARY and USE the file in order to 
close it. 


To view more details on new/enhanced dBASE II 
commands that are not mentioned in the GBASE II 
User's Guide, use the HELP command. The information 
in the HELP file supersedes the dBASE II User's Guide 
Or Reference Card information. 


Insert this replacement in the dBASE II User's Guide, 
page 8-7, BACKUP PROCEDURES: 


NOTE: Do not enter a file type extention to the 
filename. dBASE II automatically appends the file 
type extension "DBF" to the filename. 


Follow these instructions to copy a data file from 
drive A (with the dBASE II programs) to drive B: 


1) Insert the formatted backup diskette into 
drive B. 

2) USE <filename> 

3) COPY TO B:<new filename> 

4) Remove the backup diskette from drive B. 

5) Take the appropriate action with the original 
file. This can mean doing nothing, renaming 
the file, or deleting it. 


If the data file is on drive B and you want to copy 
it to drive A, follow these instructions: 


1) SET DEFAULT TO B: 
2) USE <filename> 
3) COPY TO A:<new filename> 


The sample application detailed in Appendix H of the 
GBASE II User's Guide has been modified. Therefore, 
the listing in Appendix H will not coincide line by 
line with the programs on the diskette. It is 
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advisable to print a listing of the program files 
from the diskette and replace it with the listing in 
Appendix H. 


Several utilities are provided on your diskette. Use 
the HELP UTILITIES command for a more detailed 
explanation of their use. 

SETS . PRG 

LABELS.PRG (uses NAMES.DBF) 

CREATE. PRG 

DATER. PRG. 


Several sample files are provided on your diskette. 
Use the HELP EXAMPLES command for a more detail 
explanation of their use. These examples have been 
tested, however certain combinations may cause errors 
to occur. 


The master programs are marked with a '>'. 


E E T E 
>CMAIN. PRG TEXT. DBF CPRINT.PRG KEYWORD.NDX 
APPECARD.FMT TICKLE.NDX TICKLE.FRM EDITCARD. FMT 


CHECKBOOK MANAGEMENT FILES 


>CHXMENU.PRG CHXINPUT.FMT CHXDEPOS.FMT CHXBOOK.MEM 
CHECKS.DBF DEPOSIT. DBF 


INVENTORY MANAGEMENT FILES 
>IMAIN.PRG INVENT. DBF ISETUP.PRG I'BYNMBR.NDX 


INVMAINT.PRG I'BYDESC.NDX INVQUAN.PRG INV'CONS.FRM 
INVREAD.PRG INV'PRTR.FRM INVRPRT.PRG 


NOTE: To initialize the INVENT.DBF database run 
command DO ISETUP. 


PERSONNEL MANAGEMENT FILES - EXAMPLE 1 
>EMAIN.PRG EMP .DBF ESETUP.PRG EMPSCRN. FMT 


EMP-ENTR.PRG EMP-UPD.FMT EMP-UPD.PRG EMP-PRT.FRM 
EMP-TERM.PRG EMP-CONS.FRM EMP-RPRT.PRG E'BYNMBR.NDX 
EMPLOYEE.MEM E'BYNAME.NDX 


NOTE: The database file used in this example is 
EMP.DBF (and not EMPLOYEE.DBF). To initialize 
the EMP.DBF database run command DO ESETUP. 


NEL M EMENT FILES - 4 2 


>DEMO.PRG EMPLOYEE.DBF JOBDET.DBF UPDATED. PRG 

VIEWDM.PRG ADDM.PRG CHANGEDM.PRG DELETEDM.PRG 
REPORTDM.PRG REPT1DM.PRG REPT2DM.PRG REPT3DM.PRG 
MIDFORM. FRM MIDPOINT.DBF SALINCR.FRM DPTNDXDM.NDX 
STRUCTX.DBF TEMPDM.MEM 


NOTE: The database files used in this example are 
EMPLOYEE.DBF and JOBDET.DBF. 


FORM LETTER GENERATOR/MAILING LABEL FILES 


>MAIL.PRG MAIL.DBF MAILENTR.PRG MAILLAB.PRG 
MAILLTTR.PRG MAILFMT.FMT MAILINFO.PRG PRINT.TXT 


19. Do not use the LOCK () and UNLOCK commands with the 
CP/M-86 operating system. 


20. The LOCK () and UNLOCK commands have not been tested 
with the concurrent CP/M-86 operating system. 


7.0 PROBLEMS FIXED: 


l. Multiple indexes - the system will automatically 
update all indexes when new records are added to a 
file. Even when the file is used with multiple 
indexes or the SET INDEX TO command includes an index 
list. 


2. In the APPEND mode with over 23 fields, pressing a 
carriage return on the first field of the second 
screen will not terminate record entry. 


3. Fixed data corruption when no datum was entered after 
INSERT command. 


4. APPEND and COPY null line problem fixed. 


5. APPEND to an empty database dumps no garbage after 
SET CARRY ON. 


6. BROWSE of field with length a multiple of 80 problem 
fixed. 


7. Disabled erroneous <CTRL><T> and <CTRL><N> in BROWSE. 
8. TEST function relations problem fixed. 
9. If intermediate string (€.g., Created by macros) 


exceeds 255 characters, string concatenation gives 
error message. 
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GO TO RECORD <n> now positions index file correctly. 
Internal handling of .AND. stacking fixed. 


Problem with LOOP occasionally jumping to wrong ENDDO 
fixed. 


Null format files no longer create a problem. 


CANCEL and error handler will now close all open 
command files. 


SET ALTERNATE TO (null) does not create an empty .TXT 
file. 


RENAME now makes dBASE discard all knowledge of the 
old filename. 


Fixed EOF function report after PACK of empty indexed 
file. 


PACK now recovers records after system crash by 
looking for the actual end-of-file. 


Fixed full screen entry of numeric data when CONFIRM 
is SET ON. 


Improved numeric handling in Full Screen Edit mode. 


!Non-full screen EDIT handles coordinates like 


pre-full screen EDIT (not applicable to the APC). 


SET LINKAGE ON works with a mixture of indexed and 


non-indexed databases. 


SET ESCAPE ON now works with ACCEPT and INPUT 


commands. 


DISPLAY STRUCTURE with empty structure causes no 


problem. 


DISPLAY FILES LIKE *.* does not interfere with 
ALTERNATE file. 


DISPLAY MEMORY properly accounts for logical variable 
size. 


TOTAL FOR <condition>, where condition was never 
true, now fixed. 


SUM TO <memvar> now allows <memvar> to be 10 
characters long. 
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30, 


31; 


32. 
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34. 
35; 


36. 


37. 


38. 


Problem with numeric pictures in SAY command now 
fixed. 


TOTAL command with FIELDS phrase documentation 
corrected. FIELDS phrase does not determine field in 
the TO file. 


Null form name aborts REPORT, does not create an 
empty .FRM file. 


Syntax error during subtotal expression in REPORT now 
handled. 


REPORT handles 14 fields with totaling and 
subtotaling. 


CANCEL and ERROR abort resets DO CASE depth gauge. 


CASE statements in the DO CASE command will now next 
correctly. 


MODIFY COMMAND file handling improved. 

To exit and keep the changes, press <CTRL><W>. 
Press <CTRL><Q> to exit without any changes. 
The message "ABORTING MODIFY (Y/N)" appears. 
Respond with N to continue editing. 

Respond with Y to return to the dot prompt. 


“MODIFY COMMAD* does not create a file AD.CMD or 
D.PRG. 


Obscure data corruption when using SORT on a file 
with a very rare geometry has been fixed. 
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